home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / hc.lbr / hc.doc < prev   
Text File  |  2011-02-02  |  3KB  |  66 lines
  1. ***************************************************************
  2. *              [[hc.com]]                  *
  3. ***************************************************************
  4.  
  5.         (C) 1983 Martin Smith
  6.  
  7. Hex File converter.  Converts to and from HEX format. Can
  8. automatically provide a COM or EXE extension.
  9.  
  10. Format:
  11.       >hc [d:][path]infile [[d:][path]outfile]
  12.  
  13. If TWO files are supplied, one of them MUST be HEX.
  14.  
  15. o    First file = HEX, program does HEX -> COM, EXE or BIN.
  16.  
  17. o    First file = COM, EXE or BIN, program does COM -> HEX.
  18.  
  19. If ONE file is supplied, the following takes place:
  20.  
  21. o    First file = no extension or anything other than HEX,
  22.  
  23.         Second file is created in HEX format.
  24.  
  25. o    First file = HEX extension,
  26.  
  27.         Second file is created with COM or EXE extension,
  28.             depending on file type.
  29.  
  30. If NO files are supplied, a short documentation is printed.
  31.  
  32. Ironically, you need a hexconverter to download HC.HEX. If you are
  33. on a board with XMODEM protocol, you can download HC.COM directly,
  34. but if not, use your present hexconverter to convert HC.HEX to HC.COM.
  35.  
  36. There are a lot of hexconverters out there in BBSland for IBM(tm)
  37. and compatible computers, all following the same basic format.
  38. Being written entirely in assembler, HC.COM is only 3311 bytes(com),
  39. and 6850 bytes(hex). It is small, but it can convert files up to the
  40. MS-DOS(tm) limit with no problem, and total conversion time for a
  41. 70K hex download on floppies is about 15 seconds.
  42.  
  43. HC.COM uses only regular MS-DOS 2.x function calls, so compatibility
  44. should be no problem. PATH names are fully supported. Users of DOS 1.1
  45. and earlier should not attempt to use this program.
  46.  
  47. A hexconverter is a tool for sending machine format files over the
  48. telephone.  When a BBS system is operating at seven data bits per
  49. byte, eight bit files cannot be sent. The hexconverter divides each
  50. byte into two bytes, so that all information is preserved. When it
  51. operates in reverse, the hex file is converted back to its original
  52. form, and checked for accuracy with a number placed at the end of
  53. the file called unsurprisingly a checksum. This is simply the number
  54. values of the bytes in the file added together modulo 2048 in this
  55. case.
  56.  
  57. Program by:
  58.  
  59. Marty Smith             CompuServe   72155,1214
  60. 310 Cinnamon Oak Lane         (713) 661-1241 [Office]
  61. Houston, TX  77079         (713) 464-6737 [Home]
  62. 12/10/83
  63.  661-1241 [Office]
  64. Houston, TX  77079         (713) 464-6737 [Home]
  65. 12/10/83
  66.